home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / cpanels / zcontrol.lzh / ZCONTROL.TXT < prev    next >
Encoding:
Text File  |  1995-07-21  |  21.9 KB  |  710 lines
  1.                            Die Anleitung zu
  2.  
  3.                                zControl
  4.  
  5.                                  0.20
  6.                             21. Juli 1995
  7.  
  8.                                  von
  9.  
  10.                            Ralf Zimmermann
  11.                             Am Ruhwehr 35
  12.                           D-65207 Wiesbaden
  13.  
  14.                            dl1fdt@amsat.org
  15.  
  16.  
  17.  
  18. Inhaltsverzeichnis
  19. ==================
  20.  
  21.  1 Diese Version
  22.  
  23.  2 Copyright
  24.    2.1 Shareware
  25.    2.2 Preisliste
  26.  
  27.  3 Entstehungsgeschichte
  28.  
  29.  4 Installation
  30.  
  31.  5 Bedienung des Programms
  32.    5.1 Hauptdialog
  33.    5.2 Popup-Dialog 'Optionen'
  34.    5.3 Voreinstellung
  35.    5.4 Modul-Auswahl
  36.    5.5 Selektieren eines Moduls
  37.    5.6 Starten eines Moduls
  38.    5.7 Tastaturbedienung
  39.    5.8 Parameter-Übergabe an zControl
  40.        5.8.1 Anwendung anmelden
  41.        5.8.2 AV-Protokoll
  42.        5.8.3 Drag&Drop
  43.    5.9 Iconifizierung
  44.  
  45.  6 Die INF-Datei
  46.    6.1 Debug-Funktion
  47.    6.2 Wo wird die INF-Datei gesucht?
  48.  
  49.  7 Undokumentierte Funktionen
  50.    7.1 KONFIG.CPX
  51.    7.2 LINK_CPX.CPX
  52.    7.3 DFREE.CPX
  53.  
  54. Anhang
  55.  
  56.  A Das Format der INF-Datei
  57.  
  58.  B Bezugsquellen
  59.  
  60.  C Danksagungen
  61.  
  62.  
  63.  
  64. 1 Diese Version
  65. ===============
  66.  
  67. Das Programm ist noch nicht ganz fertig! Ich würde es als eine *gut
  68. getestete* Beta-Version bezeichnen.
  69.  
  70. Ich habe aber im Moment nicht sehr viel Zeit und kann nicht absehen,
  71. wann all das eingebaut ist was ich gerne noch machen würde. In der
  72. letzten Zeit haben sich die Anfragen nach diesem Programm gehäuft.
  73. Ich habe mich deshalb entschlossen, erstmal diese Version an die
  74. Öffentlichkeit zu bringen - denn das Programm funktioniert eigentlich
  75. ohne größere Probleme. Sobald ich wieder etwas mehr Zeit habe kommt
  76. eine neue Version!
  77.  
  78. Heute fliege ich erstmal für ein paar Monate nach Florida - meine
  79. Diplomarbeit machen, dann sehen wir weiter...
  80.  
  81. 'Ohne größere Probleme' heißt in diesem Fall folgendes: In dieser
  82. Version läuft zControl als ACCessorie nur unter Multitasking-
  83. Systemen. Sobald man versucht das Programm z.B. unter TOS 3.06 als
  84. ACC zu starten bekommt man beim booten einen kräftigen Absturz.
  85.  
  86. Bisher weiß ich leider nicht woran es liegt und kann deshalb nichts
  87. daran ändern. Ich selbst benutze MagiC!3 bzw. MagicMac. Hoffen wir
  88. also auf einen Geistesblitz und auf die Zukunft. Dann wird zControl
  89. auch für die (immer noch vorhandenen) Benutzer von Single-Tasking-
  90. Systemen auf dem Atari verwendbar sein.
  91.  
  92. Als ACC unter Single-TOS wird beim booten eine Warnmeldung
  93. ausgegeben. Dabei werden keine CPX-Module geladen. Man kann die
  94. Module nachträglich laden lassen. Falls es dabei zu einem Absturz
  95. kommt würde ich mich über einen Bugreport freuen, dabei bitte die
  96. verwendete Konfiguration beschreiben:
  97.  
  98. Rechner, Speicher, Betriebssystem, HD-Treiber, AUTO-Ordner-
  99. Programme...
  100.  
  101. Bekannter Fehler: Wenn man noch CPX-Fenster offen hat, während man
  102. die Module neu lädt, so bekommt man einen Absturz des Programmes.
  103. Dies wird aus Zeitgründen erst in der nächsten Version behoben.
  104.  
  105.  
  106.  
  107. 2 Copyright
  108. ===========
  109.  
  110. zControl ist ein Shareware-Programm von
  111.  
  112.    Ralf Zimmermann
  113.    Am  Ruhwehr  35
  114.    65207 Wiesbaden
  115.  
  116.    MausNet     :  Ralf Zimmermann @ OF2
  117.    internet    :  dl1fdt@amsat.org
  118.    PacketRadio :  DL1FDT@DB0GV
  119.  
  120.    Bankverbindung:
  121.    Naspa Wiesbaden
  122.    BLZ  510 500 15
  123.    Kto 1010 299 72
  124.  
  125. Der schnellste Weg, den Autor zu erreichen, ist sicherlich die email!
  126.  
  127.  
  128. 2.1 Shareware
  129. -------------
  130.  
  131. Dieses Programm wird als Shareware vertrieben. Das heißt, Sie können
  132. das Programm beliebig und in vollem Umfang testen. Unter Testen
  133. verstehe ich einen Zeitraum von ca. 3 Wochen. Danach sollte klar
  134. sein, ob Sie das Programm weiter benutzen wollen oder nicht.
  135.  
  136. Welche Einschränkung hat das Programm in der Öffentlichen Version?
  137.  
  138. *- Keine -*
  139.  
  140. Denn es gibt keine andere Version von zControl! Die Funktionen des
  141. Programms werden in der öffentlichen Version also *nicht*
  142. eingeschränkt! Somit handelt es sich bei zControl um einen *echten*
  143. Vertreter der Gattung Shareware.
  144.  
  145. Mit der Registrierung bezahlen Sie ein Programm, welches Sie schon
  146. besitzen und ausgiebig testen konnten. Viel fairer kann man Software
  147. wohl kaum anbieten. Ich hoffe das zahlt sich (trotzdem) aus.
  148.  
  149. Wenn Ihnen das Programm gefällt und es weiter benutzen wollen, so
  150. müssen Sie sich bei dem Autor registrieren lassen. Die erfolgt
  151. einfach durch Zahlung des Shareware-Beitrags von DM 10, als
  152. Überweisung, Bargeld oder Verrechnungsscheck.
  153.  
  154. Bitte beachten Sie folgendes: Wenn Sie ein Shareware-Programm
  155. benutzen ohne sich registrieren zu lassen, dann benutzen Sie eine
  156. Raubkopie!
  157.  
  158. Standard-Disclaimer:
  159.  
  160.     Das Programm wurde mit Sorgfalt erstellt. Der Autor übernimmt
  161.     allerdings keinerlei Verantwortung für irgendwelche Schäden, die
  162.     im Zusammenhang mit der Benutzung, Nicht-Benutzung oder
  163.     Verschmutzung von zControl entstehen.
  164.  
  165.  
  166. 2.2 Preisliste
  167. --------------
  168.  
  169. Gegenwärtig kostet die Registrierung von zControl auf einen einzelnen
  170. Benutzer:
  171.  
  172.     DM 10,-
  173.  
  174.  
  175.  
  176. 3 Entstehungsgeschichte
  177. =======================
  178.  
  179. Von Atari wird seit TOS 2.00 das Accessory XCONTROL.ACC mitgeliefert.
  180. Es dient als Umgebung für die CPX-Module. Das sind Module, mit denen
  181. man den Rechner bzw. die Software konfigurieren kann. Es gibt z.B.
  182. Module zur Konfiguration der seriellen Schnittstellen, der Tastatur
  183. und des Druckers. Mancher Software liegt auch ein CPX-Modul bei. Die
  184. Module erkennt man an der Datei-Endung '.CPX'.
  185.  
  186. Die Module sind ohne ein modulares Kontrollfeld (zControl oder
  187. XControl) nicht lauffähig!
  188.  
  189. Nachdem sich mittlerweile gezeigt hat, daß XControl wohl ein paar
  190. Bugs hat, entstand die Idee eine Alternative zu schaffen.
  191.  
  192. *Diese Alternative soll nun zControl bieten.*
  193.  
  194. Es lädt die gleichen CPX-Module wie XControl und verhält sich
  195. weitgehend kompatibel, soweit es die Dokumentation zu den CPX-Modulen
  196. verlangt.
  197.  
  198. Die Vorteile gegenüber XControl liegen auf der Hand:
  199.  
  200.    ∙ zControl wird weiterentwickelt, d.h. eventuelle auftretende
  201.      Probleme werden behoben.
  202.  
  203.    ∙ zControl unterstützt moderne Protokolle:
  204.  
  205.       - Drag&Drop
  206.  
  207.       - Iconifizierung
  208.  
  209.       - AV-Protokoll
  210.  
  211.      Das bedeutet, daß sich das Programm perfekt in moderne
  212.      Benutzeroberflächen integriert.
  213.  
  214.    ∙ zControl ermöglicht das gleichzeitige arbeiten mit mehreren
  215.      Modulen! Jedes CPX-Modul läuft dabei in einem eigenen Fenster.
  216.  
  217.    ∙ zControl kann weitgehend per Tastatur bedient werden.
  218.  
  219.    ∙ zControl enthält weitere nützliche Features, die mancher
  220.      vielleicht schon vermißt hat.
  221.  
  222.  
  223.  
  224. 4 Installation
  225. ==============
  226.  
  227. Kopieren Sie die Datei ZCONTROL.ACC auf die oberste Ebene Ihres
  228. Bootlaufwerkes. Erzeugen Sie sich auf Ihrem Laufwerk einen Ordner mit
  229. dem Namen CPX und kopieren Sie Ihre CPX-Module dort hinein. Natürlich
  230. darf der Ordner auch anders heißen. Dann booten Sie den Rechner neu.
  231.  
  232. Nun rufen Sie das Programm über den Eintrag in der Menuzeile auf.
  233. Klicken Sie auf den Knopf 'Optionen' im Hauptdialog. In dem
  234. erscheinenden Popup-Dialog wählen Sie den Eintrag
  235. 'Voreinstellung...'. Dort klicken Sie auf den Eintrag der unter 'CPX
  236. Verzeichnispfad' steht. In dem erscheinenden Dateiauswahldialog geben
  237. Sie an, aus welchem Ordner die CPX-Module geladen werden sollen. Die
  238. Bestätigung erfolgt mit dem 'OK'-Knopf. Üblicherweise sollte dies
  239. z.B. ein Ordner mit folgendem Pfad sein:
  240.  
  241. C:\CPX\
  242.  
  243. Klicken Sie auf den Knopf 'Sichern' und bestätigen Sie die
  244. Sicherheitsabfrage. Danach sollte zControl bei jedem Start die CPX-
  245. Module im richtigen Ordner suchen.
  246.  
  247. Unter Multitasking-Systemen kann zControl natürlich auch als
  248. Applikation gestartet werden. Man ändert dazu den Programmnamen von
  249. .ACC auf .APP oder .PRG und schon kann man zControl als normales
  250. Programm laufen lassen.
  251.  
  252.  
  253.  
  254. 5 Bedienung des Programms
  255. =========================
  256.  
  257. Im folgenden wird kurz auf die Bedienung des Programmes eingegangen.
  258.  
  259.  
  260. 5.1 Hauptdialog
  261. ---------------
  262.  
  263. Nach dem Starten des Programmes öffnet sich der Hauptdialog. Dort
  264. wird angezeigt, welche CPX-Module geladen wurden und somit verfügbar
  265. sind. Wurden mehr Module gefunden, als in den Dialog passen (was die
  266. Regel ist), so kann man mittels dem rechts angeordneten vertikalen
  267. Schieber die anderen Einträge erreichen.
  268.  
  269. ACHTUNG:
  270. In der Beta-Version wird der Fenstertitel als Laufschrift
  271. dargestellt. Dies soll einen daran erinnern, daß es sich eben um eine
  272. Vorab-Version handelt!
  273.  
  274.  
  275. 5.2 Popup-Dialog 'Optionen'
  276. ---------------------------
  277.  
  278.    ∙ Info...
  279.      Unter diesem Punkt erhalten Sie einen kurzen Copyright-Hinweis
  280.      zu dem Programm, unter anderem steht hier auch die
  281.      Versionsnummer des Programmes.
  282.  
  283.    ∙ Voreinstellung...
  284.      Mit diesem Punkt kommen Sie zu einem Dialog, der Ihnen die
  285.      Konfiguration des Programmes ermöglicht.
  286.  
  287.    ∙ Öffne CPX...
  288.      Falls ein Modul selektiert ist, können Sie es hier starten,
  289.      genau so als ob Sie einen Doppelklick auf den Modul-Eintrag
  290.      gemacht hätten.
  291.  
  292.    ∙ CPX Info...
  293.      Falls ein Modul selektiert ist, erhalten Sie hier ein paar
  294.      interne Informationen über das Modul.
  295.  
  296.  
  297. 5.3 Voreinstellung
  298. ------------------
  299.  
  300. In diesem Dialog kann man
  301.  
  302.    ∙ CPX-Module neu laden.
  303.  
  304.    ∙ in den Dialog zur Modul-Auswahl wechseln.
  305.  
  306.    ∙ die Anzahl der angezeigten CPX-Einträge im Hauptdialog
  307.      bestimmen.
  308.  
  309.    ∙ das Verzeichnis, in dem die CPX-Module gesucht werden,
  310.      einstellen.
  311.  
  312.  
  313. 5.4 Modul-Auswahl
  314. -----------------
  315.  
  316. In diesem Dialog kann man auswählen, welche CPX-Module beim nächsten
  317. Laden berücksichtigt werden sollen. Aktive Module werden in der Liste
  318. mit einem Haken vor dem Eintrag dargestellt.
  319.  
  320. Durch einen Mausklick auf einen Eintrag kann man den Status des
  321. Moduls verändern.
  322.  
  323. Hinweis: Das (de)aktivieren wird auf dem Laufwerk durch verändern der
  324. Datei-Endung erreicht. Aktive Module haben die Endung '.CPX' und
  325. deaktivierte Module die Endung '.CPZ'.
  326.  
  327.  
  328. 5.5 Selektieren eines Moduls
  329. ----------------------------
  330.  
  331. Ein Modul wird durch einen einfachen Klick mit der linken Maustaste
  332. auf den Eintrag selektiert. Die Selektion ist durch die invertierte
  333. Darstellung erkennbar. Wenn man ein Modul selektiert hat, kann man
  334. mit dem Popup-Dialog 'Optionen' weitere Informationen zu dem Modul
  335. erhalten.
  336.  
  337.  
  338. 5.6 Starten eines Moduls
  339. ------------------------
  340.  
  341. Ein Modul wird durch
  342.  
  343.    ∙ einen Doppelklick mit der Maus auf den CPX-Eintrag
  344.  
  345.    ∙ drücken der Return-Taste bei selektiertem Eintrag
  346.      (siehe Tastaturbedienung)
  347.  
  348.    ∙ eine VA_START-Meldung
  349.  
  350.    ∙ eine Drag&Drop-Meldung
  351.  
  352. gestartet.
  353.  
  354. Es wird für jedes laufende CPX-Modul ein eigenes Fenster geöffnet.
  355. Man kann in zControl gleichzeitig mehrere CPX-Module offen haben! Zur
  356. Zeit werden maximal 4 CPX-Fenster unterstützt, diese Zahl ist
  357. willkürlich gewählt und kann in Zukunft erweitert werden.
  358.  
  359.  
  360. 5.7 Tastaturbedienung
  361. ---------------------
  362.  
  363. zControl läst sich im Hauptdialog weitgehend per Tastatur bedienen:
  364.  
  365.    Cursor-Hoch      - Bewegt den Selektierbalken um eine Position nach
  366.                       oben.
  367.                     - Falls noch keine Selektion existiert, wird der
  368.                       unterste Eintrag im Fenster selektiert.
  369.    Cursor-Runter    - Bewegt den Selektierbalken um eine Position nach
  370.                       unten.
  371.                     - Falls noch keine Selektion existiert, wird der
  372.                       oberste Eintrag im Fenster selektiert.
  373.    Shift-Cursor     - Bewegt den Selektierbalken Seitenweise.
  374.    Return
  375.    Enter            - Falls eine Selektion existiert, so wird das
  376.                       entsprechende CPX-Modul aufgerufen.
  377.                     - Existiert keine Selektion, so wird das
  378.                       Fenster geschlossen.
  379.    Esc              - Hebt eine eventuell existierende Selektion auf.
  380.    Control-U
  381.    Control-Q        - Das Fenster wird geschlossen.
  382.    Control-Alternate-Leertaste
  383.                     - Das Fenster wird iconifiziert
  384.                       (siehe Iconifizierung)
  385.  
  386.  
  387. 5.8 Parameter-Übergabe an zControl
  388. ----------------------------------
  389.  
  390. Beim Start als Programm kann man zControl Parameter übergeben. Bisher
  391. wird die Kommandozeile lediglich nach dem Namen eines CPX-Moduls
  392. abgesucht. Falls das entsprechende Modul beim Start von zControl
  393. geladen wurde, wird es aktiviert.
  394.  
  395.  
  396. 5.8.1 Anwendung anmelden
  397.  
  398. Es empfiehlt sich, zControl als Anwendung für die Datei-Endung
  399. '*.CPX' anzumelden. Im Atari-Desktop funktioniert dies, indem man das
  400. Programm selektiert und im Menu die Funktion 'Anwendung anmelden'
  401. auswählt. Dort trägt man die Endung 'CPX' für das Programm ein.
  402. Danach muß diese Einstellung noch gesichert werden, mittels 'Arbeit
  403. sichern'.
  404.  
  405. Wenn man dann ein Doppelklick auf eine CPX-Datei macht, so wird
  406. zControl gestartet und die gewählte CPX-Datei aktiviert. Damit hat
  407. man die Möglichkeit, CPX-Module als Icon auf den Desktop zu legen und
  408. per Doppelklick direkt aufzurufen.
  409.  
  410. Unter dem Desktop-Ersatz 'Gemini' kann man unter 'Anwendungen...' die
  411. Option 'Versteht VA_START-Meldung' aktivieren. Falls zControl schon
  412. gestartet ist, übergibt Gemini den Modulnamen per VA_START-Message
  413. als Parameter.
  414.  
  415. Tip:
  416. Man kann sich eine leere Datei mit der Endung .CPX erstellen, die man
  417. lediglich zum aktivieren von zControl verwendet. Bei mir heist die
  418. datei z.B. _CALL.CPX und hat 0Bytes Größe. Diese Datei habe ich als
  419. Icon auf dem Desktop liegen, ein Doppelklick darauf aktiviert das als
  420. Accessorie installierte zControl.
  421.  
  422.  
  423. 5.8.2 AV-Protokoll
  424.  
  425. zControl versteht die Meldung VA_START des AV-Protokolls. Als
  426. Parameter kann der Name eines CPX-Moduls übergeben werden. Falls das
  427. Modul schon geladen ist, wird es aktiviert. Andernfalls wird
  428. versucht, das Modul neu zu laden.
  429.  
  430. zControl versteht auch die Meldung VA_DRAGACCWIND. Man kann z.B. aus
  431. Gemini heraus eine CPX-Datei auf das zControl-Fenster ziehen und
  432. fallenlassen. Das funktioniert dann genauso wie bei Drag&Drop.
  433.  
  434.  
  435. 5.8.3 Drag&Drop
  436.  
  437. zControl versteht das Drag&Drop-Protokoll. Hat man ein
  438. Betriebssystem, welches Drag&Drop und unterstützt, so kann man
  439. einfach eine CPX-Datei vom Desktop auf das zControl-Fenster ziehen
  440. und dort fallenlassen.
  441.  
  442. Daraufhin lädt zControl das Modul und aktiviert es.
  443.  
  444. Folgende TOS-kompatible Betriebssysteme beherschen zur Zeit meines
  445. Wissens das Drag&Drop-Protokoll:
  446.  
  447.    ∙ MultiTOS mit einem AES >= 4.1
  448.  
  449.    ∙ MagiC! 3.0
  450.  
  451.    ∙ MagiCMac (auf dem Apple Macintosh)
  452.  
  453.  
  454. 5.9 Iconifizierung
  455. ------------------
  456.  
  457. Unter Iconifizierung versteht man die Verkleinerung eines normalen
  458. GEM-Fensters auf minimale Größe. Das Fenster ist dann sehr klein und
  459. zeigt nur noch ein Symbol an, nicht mehr den echten Inhalt. Besonders
  460. bei vielen offenen Fenstern ist es sehr angenehm, die geöffneten
  461. Fenster eines Programms vorübergehend 'aus dem Weg zu schaffen'.
  462.  
  463. zControl beherscht zwei verschiedene Arten des Iconify:
  464.  
  465.    ∙ MultiTOS-Iconify
  466.     
  467.      Unter MultiTOS wird rechts oben im Fenstertitel eine Iconify-
  468.      Knopf angezeigt. Klickt man darauf, so wird das Fenster zu einem
  469.      Icon verkleinert.
  470.  
  471.    ∙ ICFS-Iconify
  472.     
  473.      Falls kein Betriebssystem mit Iconify-Möglichkeiten gefunden
  474.      wird, aber der Iconify-Server (ICFS) vorhanden ist, so wird das
  475.      Iconify per ICFS unterstützt. Wenn man den Schließ-Knopf des
  476.      Fensters betätigt und gleichzeitig eine der Tasten
  477.  
  478.       - Control
  479.  
  480.       - Shift
  481.  
  482.       - Alternate
  483.  
  484.      gedrückt hält, so wird das Fenster zu einem Icon verkleinert.
  485.  
  486. Das Iconifizieren kann man auch per Tastatur mittels Control-
  487. AlternateLeertaste erreichen. Also einfach die Control- und die
  488. Alternate-Taste gedrückt halten und dann die Leertaste betätigen.
  489.  
  490.  
  491.  
  492. 6 Die INF-Datei
  493. ===============
  494.  
  495. zControl speichert seine Parameter in der Datei ZCONTROL.INF, welche
  496. beim Programmstart gesucht wird. Zur Zeit werden folgende Parameter
  497. gespeichert:
  498.  
  499.    ∙ Der Pfad aus dem die CPX-Module nachgeladen werden.
  500.  
  501.    ∙ Die Einstellung, wieviele CPX-Modul-Einträge im Hauptdialog
  502.      dargestellt werden.
  503.  
  504.    ∙ Die Position des zControl-Fensters.
  505.  
  506.    ∙ Die Positionen der CPX-Fenster.
  507.  
  508. Sämtliche Parameter werden gespeichert, wenn man im Dialog
  509. 'Optionen/Voreinstellung...' den Knopf 'Sichern' wählt.
  510.  
  511.  
  512. 6.1 Debug-Funktion
  513. ------------------
  514.  
  515. Manchmal kommt es vor, daß ein CPX-Modul Probleme bereitet. Damit man
  516. bei einer großen Zahl von Modulen herausfinden kann, welches Modul
  517. das ist, kann man eine einfache Debug-Funktion aktivieren.
  518.  
  519. Wenn man eine Zeile
  520.  
  521.    DEBUG = STDOUT
  522.  
  523. von Hand in die INF-Datei einfügt, dann wird beim Starten jedes
  524. Moduls eine kurze Text-Ausgabe erzeugt. Damit kann man z.B. beim
  525. booten herausfinden, wo das Problem liegt.
  526.  
  527.  
  528. 6.2 Wo wird die INF-Datei gesucht?
  529. ----------------------------------
  530.  
  531. zControl sucht seine INF-Datei mit den Voreinstellungen der
  532. Reihenfolge nach mit folgenden Methoden:
  533.  
  534.   1. Im AES-Environment, per shel_envrn(), wird nach der Variablen
  535.      HOME gesucht.
  536.  
  537.   2. Das beim Programmstart übergebene Environment wird nach der
  538.      Variablen HOME abgesucht.
  539.  
  540.   3. Mittels shel_read() wird versucht den Startpfad zu ermitteln.
  541.  
  542.   4. In argv[0] wird nach dem Startpfad gesucht.
  543.  
  544.   5. Auf dem Wurzelverzeichnis des Bootlaufwerks, welches mittels
  545.      _bootdev ermittelt wird. Üblicherweise also C:\.
  546.  
  547. Sobald eine der Methoden einen Pfad liefert, so wird er zum Laden und
  548. Speichern der INF-Datei verwendet.
  549.  
  550. Es wird empfohlen, die HOME-Variable zu benutzen. In Zukunft werden
  551. hoffentlich immer mehr Programme dieses Verfahren benutzen.
  552.  
  553. Unter dem Betriebssystem MagiC (oder Mag!X) kann man die HOME-
  554. Variable erzeugen indem man z.B. folgende Zeile in die Datei MAGX.INF
  555. schreibt:
  556.  
  557. Die Zeile sollte auf jeden Fall vor der Zeile mit dem #_CTR stehen.
  558.  
  559. Unter MultiTOS kann man die HOME-Variable erzeugen, indem man in der
  560. Datei GEM.CNF folgende Zeile einträgt:
  561.  
  562. setenv HOME=c:\gemini2\user
  563.  
  564.  
  565.  
  566. 7 Undokumentierte Funktionen
  567. ============================
  568.  
  569. In XControl gibt es wenigstens zwei nicht-dokumentierte Funktionen,
  570. die von manchen Modulen benutzt werden. Das sind nur sehr wenige
  571. Module, aber es gibt sie.
  572.  
  573. Zur Zeit werden nur alle dokumentierten Funktionenunterstützt. Falls
  574. man Module hat, die Probleme machen, so sollte man Vorsicht walten
  575. lassen.
  576.  
  577. Es folgt eine Auflistung der mir bekannten Module, die
  578. undokumentierte Funktionen von XControl verwenden.
  579.  
  580.  
  581. 7.1 KONFIG.CPX
  582. --------------
  583.  
  584. Es gibt ein CPX-Modul von Atari, welches leider eine Besonderheit
  585. darstellt. Es nennt sich KONFIG.CPX und dient zur Konfiguration der
  586. CPX-Header. Man kann dort z.B. die Farben des Icons und der Texte
  587. einstellen.
  588.  
  589. Leider verwendet dieses Modul nicht-dokumentierte Funktionen von
  590. XControl. Das führt zum sofortigen Absturz des Rechners.
  591.  
  592. Deshalb wird dieses Modul zur Zeit von zControl abgelehnt. Bei dem
  593. Versuch das Modul zu starten erscheint eine Fehlermeldung.
  594.  
  595.  
  596. 7.2 LINK_CPX.CPX
  597. ----------------
  598.  
  599. Das Modul von Richard Kurz verwendet ebenfalls nicht-dokumentierte
  600. Funktionen von XControl. Immerhin verhält es sich etwas kooperativer
  601. als KONFIG.CPX und stürzt nicht sofort ab...
  602.  
  603. Trotzdem ist das Modul mit Vorsicht zu geniessen, diese Funktionen
  604. werden zur Zeit einfach nicht unterstützt!
  605.  
  606.  
  607. 7.3 DFREE.CPX
  608. -------------
  609.  
  610. Dieses Modul von Andreas Mandel benutzt auch eine nicht-dokumentierte
  611. Funktion (reserve2()), ich weiß aber nicht weshalb.
  612.  
  613.  
  614.  
  615.  
  616. A Das Format der INF-Datei
  617. ==========================
  618.  
  619. zControl verwendet in seiner Parameter-Datei folgende Schlüsselworte:
  620.  
  621.    ∙ CPX_PATH
  622.      Mit diesem Parameter wird festgelegt, in welchem Pfad die CPX-
  623.      Module gesucht werden.
  624.  
  625.    ∙ ANZ_DISP_ENTRY
  626.      Mit diesem Eintrag wird festgelegt, wieviele CPX-Modul-Einträge
  627.      im Hauptdialog dargestellt werden. Man kann zur Zeit zwischen
  628.      vier und 12 Einträgen anzeigen.
  629.  
  630.    ∙ WIND_MAIN
  631.      Unter diesem Eintrag wird die Position des zControl-Fensters
  632.      gespeichert. Das Fenster wird nach dem Programmstart an dieser
  633.      Position geöffnet.
  634.  
  635.    ∙ WIND_CPX?
  636.      Hinter diesem Eintrag wird die Position eines Fensters für ein
  637.      CPX-Modul gespeichert. Anstelle des Fragezeichens steht in der
  638.      INF-Datei die Nummer des Fensters, z.B. 'WIND_CPX2' für das
  639.      zweite CPX-Fenster.
  640.  
  641.    ∙ DEBUG
  642.      Siehe Debug-Funktion.
  643.  
  644.  
  645.  
  646. B Bezugsquellen
  647. ===============
  648.  
  649. Bereits registrierte Benutzer erhalten die jeweils neueste Version
  650. des Programms beim Autor gegen Einsendung einer formatierten Diskette
  651. sowie eines frankierten und adressierten Rückumschlags. Für noch-
  652. nichtregistrierte Benutzer kommt der SharewareBetrag von 10DM hinzu.
  653.  
  654. Besitzer eines Modems finden die aktuelle Version von zControl in der
  655. Maus Offenbach 2:
  656.  
  657.    ∙ Maus OF2: 06103-921170
  658.  
  659. Der Archivname lautet jeweils ZCONTROL.LZH.
  660.  
  661. Auf jeweils neue Versionen wird in der MausNet-Gruppe "ATARI.NEWS"
  662. hingewiesen.
  663.  
  664.  
  665.  
  666. C Danksagungen
  667. ==============
  668.  
  669. Ich möchte mich bei ein paar Leuten bedanken, ohne ihre Mithilfe wäre
  670. zControl niemals so ein schönes Programm geworden. Ich habe zwar die
  671. ganze 'Dreckarbeit' gemacht, aber einige Ideen und Informationen
  672. kamen von außen.
  673.  
  674. Vielen Dank an...
  675.  
  676.    ∙ *Dirk Haun @ WI2*
  677.      für Informationen und sein aufmerksames Testen.
  678.      ("Na wer sagt's denn, es hat sich ja doch einer gefunden, der
  679.      einen XControl-Clone schreibt")
  680.  
  681.    ∙ *Julian Reschke @ WI2*
  682.      für seine Informationen bezüglich Drag&Drop und diesem ganzen
  683.      modernen Kram...
  684.  
  685.    ∙ *Martin Osieka @ OF2*
  686.      für seine Hilfe bei allerlei Problemen. Besonderer Dank gebührt
  687.      ihm für die Idee, wie man mehrere CPX-Module gleichzeitig
  688.      verwaltet! So ein echter Informatiker kann hin und wieder sehr
  689.      hilfreich sein - ich kann das nur empfehlen!
  690.      ("Bitte nicht jeden Tag eine neue Release")
  691.  
  692.    ∙ *Rainer Wiesenfeller @ RS*
  693.      für das versprochene Bier, falls ich das irgendwann bekomme.
  694.      ("... finde ich es gut, daß sich mal jemand die Mühe gibt,
  695.      dieses Programm neu zu programmieren und zu pflegen.")
  696.  
  697.    ∙ *Reiner Rosin @ WI2*
  698.      der mir seinen Gruppenprogrammteil zur Verfügung gestellt hat.
  699.      Zwar nicht freiwillig, aber immerhin...
  700.  
  701.    ∙ *Rene Bartholomay @ OL*
  702.      der die Chance genutzt hat, der erste zahlende Benutzer von
  703.      zControl zu werden. ;-)
  704.      ("Endlich mal jemand, der auch an die Großbildschirmbenutzer
  705.      denkt!")
  706.  
  707.  
  708.  
  709.  
  710.